GermanWikipedia - /page/entry.mu

Micron Document

<!DOCTYPE html>

<title>Annotation (Programmierung)</title>

</head>

<h1 id="firstHeading" class="firstHeading mw-first-heading">Annotation (Programmierung)</h1>

</header>

</div>

Annotationen (vom Lateinischen für „Anmerkung“) sind ein Mittel zur Strukturierung von <a href="Quelltext" title="Quelltext">Programmquelltexten</a>, bei der die Erzeugung von Programmtexten und mit der Programmierung verbundener Hilfsdateien teilweise automatisiert wird. Als Informationsgrundlage für die automatische Erzeugung der zusätzlichen Dateien werden Informationen aus dem Quelltext herangezogen, die man <a href="Metadaten" title="Metadaten">Metadaten</a> oder Metainformationen, Anmerkungen und Kommentare oder Attribute nennt. Bei der Übersetzung vom <a href="Compiler" title="Compiler">Compiler</a> werden die Informationen nicht beachtet.

Programmiersprachen, die diese Form der Einbindung von Metainformationen ermöglichen, sind unter anderem <a href="Java_(Programmiersprache)" title="Java (Programmiersprache)">Java</a>, <a href="C-Sharp" title="C-Sharp">C#</a> und <a href="VB.NET" class="mw-redirect" title="VB.NET">VB.NET</a>. Mit Hilfe von Zusatzwerkzeugen lassen sich Metainformationen auch in Sprachen einbetten, wenn deren Syntax diese nicht explizit unterstützt. Die Metadaten werden dann üblicherweise in Kommentaren vor dem Compiler verborgen und mit den Zusatzwerkzeugen ausgewertet.

<div class="mw-heading mw-heading2"><h2 id="Attribute_in_C#_und_VB.NET">Attribute in C# und VB.NET</h2></div>

In C# und VB.NET werden Metadaten in Form von Attributen abgebildet. Attribute können für Assemblys, Klassen, Strukturen, Methoden, Parameter, Felder und Enumerationen angegeben werden. Jedes einzelne Attribut wird in eckigen (C#) beziehungsweise spitzen Klammern (VB.NET) vor dem jeweiligen Sprachelement angegeben. Attribut-Parameter werden in gleicher Weise verwendet wie Parameter von Methoden und Eigenschaften.<a href="#cite_note-1">[1]</a>

Das folgende Beispiel zeigt, wie die Attribute <code>Obsolete</code> zum Markieren von veralteten Code sowie <code>DllImport</code> zum Einbinden von unmanaged (nativen) Assemblys via COM-Interop verwendet werden.

<div class="mw-highlight mw-highlight-lang-csharp mw-content-ltr" dir="ltr"><pre>// Eine Methode (hier Foo) als veraltet markieren.

// Der Parameter vom Typ System.String wird u. a. von IDEs als Hinweistext verwendet.

[Obsolete("Verwenden sie die Methode Bar.")]

public void Foo(string stringParam)

{

//...

}

// Import der Win32 MessageBox.

// Der Konstruktor von DllImport nimmt hier ein Argument entgegen ("user32.dll"),

// die Klasse DllImport verfügt über eine Eigenschaft CharSet, der ein Wert zugewiesen wird.

[DllImport("user32.dll", CharSet = CharSet.Unicode)]

public static extern int MessageBox(IntPtr hWnd, String text, String caption, uint type);

</pre></div>

Neben den Standard-Attributen, die das .NET-Framework bereitstellt, ist auch das Definieren eigener Attribute möglich. Hierzu muss eine eigene Klasse erstellt werden, die von <code>System.Attribute</code> ableitet.<a href="#cite_note-2">[2]</a>

Das folgende Beispiel zeigt die Definition eines einfachen Attributs <code>Autor</code>:

<div class="mw-highlight mw-highlight-lang-csharp mw-content-ltr" dir="ltr"><pre>// Definieren des Attributs "Autor"

[System.AttributeUsage(System.AttributeTargets.Class |

System.AttributeTargets.Struct)

]

public class Autor : System.Attribute

{

private string _vorname;

private string _nachname;

public Autor(string vorname, string nachname)

{

_vorname = vorname;

_nachname = nachname;

}

}

// Verwenden des Attributs "Autor"

[Autor("Max", "Mustermann")]

class BeispielKlasse

{

//...

}

</pre></div>

<div class="mw-heading mw-heading2"><h2 id="Annotationen_in_Java">Annotationen in Java</h2></div>

Die Programmiersprache Java stellt mit <a href="Javadoc" title="Javadoc">Javadoc</a> und den Annotationen zwei Mechanismen zum Einbinden von Metadaten zur Verfügung. Diese werden insbesondere im <a href="Jakarta_EE" title="Jakarta EE">Jakarta-EE</a>-Umfeld eingesetzt, um verschiedene Dateien automatisiert zu erzeugen. Dazu zählen beispielsweise SQL-Dateien, Deployment-Deskriptoren und die mit <a href="Enterprise_Java_Beans" class="mw-redirect" title="Enterprise Java Beans">Enterprise Java Beans</a> verbundenen Schnittstellen (Remote Interface, Home Interface …).

<div class="mw-heading mw-heading3"><h3 id="Javadoc">Javadoc</h3></div>

<div class="hauptartikel" role="navigation">→ Hauptartikel: <a href="Javadoc" title="Javadoc">Javadoc</a></div>

Javadoc ist ein Werkzeug zur Auswertung von Kommentaren im Quelltext, das mit Java 1.2 eingeführt wurde. Dazu werden Kommentare, die ausgewertet werden sollen mit der Zeichenkette <code>/**</code> eingeleitet. Innerhalb dieser Kommentare können dann spezielle Tags verwendet und diesen jeweils eine Zeichenkette als Wert zugewiesen werden.

Die Auswertung erfolgt mittels des gleichnamigen Werkzeugs Javadoc, das ursprünglich zur automatisierten Quelltext-Dokumentation entworfen wurde. Eine weitere Möglichkeit stellt das insbesondere im <a href="Jakarta_EE" title="Jakarta EE">Jakarta-EE</a>-Umfeld eingesetzte <a href="XDoclet" title="XDoclet">XDoclet</a> dar. Das folgende Beispiel zeigt, wie man die Softwareversion mittels Javadoc angibt:

<div class="mw-highlight mw-highlight-lang-java mw-content-ltr" dir="ltr"><pre> /**

* @version 1.5

*/

public class A {}

</pre></div>

<div class="mw-heading mw-heading3"><h3 id="Annotationen_(ab_Java_5)">Annotationen (ab Java 5)</h3></div>

Mit der Sprachversion Java 5 wurden Annotationen als ein eigenes Sprachelement geschaffen. Annotationen werden im Quelltext durch ein @-Zeichen gefolgt vom Namen der Annotation gekennzeichnet. Zusätzlich ist es auch möglich, Annotationen Parameter zu übergeben. Außerdem können den vorgegebenen Annotationen auch eigene hinzugefügt werden.

Annotationen können mittels des <a href="Annotation_(Java)" title="Annotation (Java)">Annotation Processing Toolkits (APT)</a> direkt im Quelltext oder mittels <a href="Reflexion_(Programmierung)" title="Reflexion (Programmierung)">Reflexion</a> zur Laufzeit eines Programms ausgewertet werden. Unter anderem dadurch entstehen weitere Einsatzmöglichkeiten im Vergleich zu Javadoc. So wertet beispielsweise der Compiler selbst einige Annotationen aus. Das folgende Beispiel zeigt, wie man eine Compiler-Warnung mittels der entsprechenden Annotation unterdrückt:

<div class="mw-highlight mw-highlight-lang-java mw-content-ltr" dir="ltr"><pre> public class A {

@SuppressWarnings("unchecked")

public void meineMethode() {}

}

</pre></div>

Ab Java 6 ist das APT-Werkzeug bereits im Java-Compiler integriert und Teil des Standardkompilierungsprozesses. Ab Java 8 wird das APT-Werkzeug nicht mehr separat ausgeliefert, da die Annotation-Verarbeitung vollständig von der integrierten Compiler-API übernommen wird.

<div class="mw-heading mw-heading2"><h2 id="Einzelnachweise">Einzelnachweise</h2></div>

<li id="cite_note-1"><a href="#cite_ref-1">↑</a> Microsoft Developer Network: <a rel="nofollow" class="external text" href="https://msdn.microsoft.com/de-de/library/z0w1kczw(v=VS.100).aspx">Attribute (C# und Visual Basic).</a> Abgerufen am 29. November 2011.<span style="display: none;" class="Z3988" title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adc&rfr_id=info%3Asid%2Fde.wikipedia.org%3AAnnotation+%28Programmierung%29&rft.title=Attribute+%28C%23+und+Visual+Basic%29&rft.description=Attribute+%28C%23+und+Visual+Basic%29&rft.identifier=https%3A%2F%2Fmsdn.microsoft.com%2Fde-de%2Flibrary%2Fz0w1kczw%28v%3DVS.100%29.aspx&rft.creator=Microsoft+Developer+Network">

</li>

<li id="cite_note-2"><a href="#cite_ref-2">↑</a> MSDN: <a rel="nofollow" class="external text" href="https://msdn.microsoft.com/de-de/library/sw480ze8.aspx">Erstellen benutzerdefinierter Attribute (C# und Visual Basic).</a> Abgerufen am 29. November 2011.<span style="display: none;" class="Z3988" title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Adc&rfr_id=info%3Asid%2Fde.wikipedia.org%3AAnnotation+%28Programmierung%29&rft.title=Erstellen+benutzerdefinierter+Attribute+%28C%23+und+Visual+Basic%29&rft.description=Erstellen+benutzerdefinierter+Attribute+%28C%23+und+Visual+Basic%29&rft.identifier=https%3A%2F%2Fmsdn.microsoft.com%2Fde-de%2Flibrary%2Fsw480ze8.aspx&rft.creator=MSDN">

</li>

</ol></div><div><div class="zim-footer">

Dieser Artikel wurde von <a class="external text" title="Zuletzt bearbeitet am 2025-08-22" href="https://de.wikipedia.org/wiki/?title=Annotation_(Programmierung)&oldid=259091023">Wikipedia</a> herausgegeben. Der Text ist unter <a class="external text" href="https://creativecommons.org/licenses/by-sa/4.0/deed.de">Creative Commons Attribution-Share Alike 4.0</a> verfügbar, sofern nicht anders angegeben. Für die Mediendateien können zusätzliche Bedingungen gelten.

</div>

</div></div>

</div>

</main>

</div>

</body></html>